Cleaning Persistence Data Using lsclean

Lsclean is a Sentinel RMS utility that your customers can use to clean up their systems. This utility is available at ...\<version>\Legacy\VendorTools. For detailed steps about using lsclean, click here.

>The error VLS_TRIAL_LIC_DATA_INCONSISTENT/SNTL_TRIAL_LIC_DATA_INCONSISTENT may appear in the case of a trial license when the system is either not initialized or corrupted.

>In the case of a commuter license, the License Manager may fail to mark a network license as checked-out.

>The error VLS_CLK_TAMP_FOUND/SNTL_CLK_TAMP_FOUND may appear in the case of system time tampering.

To recover from such conditions, a clean up of persistence data is required, for the various types of license. For more information, refer to Types of Licenses That May Need Cleaning .

There are two ways to clean up corrupted persistence data:

>Using the utilities

>Using the persistence cleaning API functions

In this appendix, we provide complete details about persistence data cleaning workflow using the utilities. If you do not want to use the utilities to clean up systems, consider using the Cleaning Persistence Data Using Unified API.

Types of Licenses That May Need Cleaning

The following license models/attributes need cleaning up in the case of persistence data corruption:

Exhausted Trial Licenses

The trial licenses are used for limited time period (trial days and hours). When the user starts the application for the first time, the Sentinel RMS library writes trial license information (such as feature, version, and first usage date) into the its persistence file. After completion of the trial period, if the users attempts to reuse the license, it shows error VLS_TRIAL_LIC_EXHAUSTED/SNTL_TRIAL_LIC_EXHAUSTED.

Commuter Licenses

When a user checks out a commuter-enabled network license, both the client and License Manager persistence is updated for that feature-version. If the client becomes permanently non-accesible (for example, a client machine that gets physically damaged), the License Manager persistence can be cleaned.

Time Tampering-Enabled Licenses

The time tampering information does not allow an end user to set the system time back. If the user attempts to set the system time back for a time tampering enabled license, Sentinel RMS generates error VLS_CLK_TAMP_FOUND/SNTL_TRIAL_LIC_EXHAUSTED. This behavior may occur on a standalone or network system.

NOTE The time tampering error is not shown for a license which has the time tampering check enabled, but has end date set as “Never”.

Grace Licenses

Grace licenses provide high availability and high assurance to the basic network license. A user can run the licensed application without interruption up to the grace period in the case of network unavailability or when the License Manager is rebooted. When a user obtains a grace-enabled network license, the grace license persistence information is created on the local system.

Revocation Licenses

Sentinel RMS allows customers to revoke licenses. It can be useful under the following scenarios:

>Returning unused licenses

>Transferring licenses from one network to another

The revocation persistence information is updated on a standalone system and in the License Manager persistence, depending upon the scenario. Since revocation is offered only from Sentinel RMS 8.0, the cleaning of its persistence is available only in Sentinel RMS versions 8.x.x (and later) libraries.

Cloud Usage-enabled Licenses

Cloud usage-enabled licenses created for the On-premises and Lease modes.